home *** CD-ROM | disk | FTP | other *** search
/ Merciful 5 / Merciful - Disc 5.iso / software / h / hypertextdatav40.12cr.lha / HTDS / Docs / HWObtainGIRPort < prev    next >
Encoding:
Text File  |  1996-08-25  |  1.9 KB  |  55 lines
  1. For those of you who think they have to use something like
  2. the NewObtainGIRPort hack or any equivalent OS patch which can be
  3. subsumed under the familiar name of NewObtainGIRPort:
  4.  
  5. NewObtainGIRPort is
  6.  
  7.     a) useless, because it is not really fixing things.
  8.        At least the 1.1 code is buggy.
  9.  
  10.     b) the wrong approach, because the application having the
  11.        problem should be fixed. The OS is ok.
  12.  
  13. You are asking why I am saying that? Let me explain.
  14.  
  15. ObtainGIRPort() will also do a layer lock. This is unfortunately
  16. not mentioned in the autodocs. But it is described that you may not
  17. cache that RastPort:
  18.  
  19.    This function must be called EACH time a hook routine needing
  20.    to perform gadget rendering is called, and must be accompanied
  21.    by a corresponding call to ReleaseGIRPort().
  22.  
  23. This is obviously a strong indicator that you
  24.  
  25.     a) may only use simple rendering calls (That's what the
  26.         function is for: rendering)
  27.     b) may not give control back to Intuition either by leaving the
  28.        context or by calling Intuition functions before you called
  29.        ReleaseGIRPort().
  30.  
  31. Once you know that ObtainGIRPort() does a layer lock, you can look
  32. up the LockLayer() autodoc, too:
  33.  
  34.    Further Note: while you hold the lock on a layer, Intuition will block
  35.        on operations such as windowsizing, dragging, menus, and depth
  36.        arranging windows in this layer's screen.  It is recommended that
  37.        YOU do not make Intuition function calls while the layer is locked.
  38.  
  39. So everyone who is currently using a hack like NewObtainGIRPort
  40. should better complain to the authors of the application that
  41. causes the problems in the first place.
  42.  
  43. Heinz Wrobel
  44. <heinz@amiga.de>
  45.  
  46. ------------------------------------------------------------------------------
  47. Text included with permission from Heinz Wrobel from the
  48. Amiga Developer-CD V1.1 for the HyperText-Datatype-System.
  49.  
  50. Thanx Heinz
  51.  
  52. Stefan Ruppert
  53.  
  54.  
  55.